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THE TROP USER mm. CONSISTS OF THE FOLLnUING SECTIOLS: 
SECTION 1. TROP INTRODUCTION 

SECTION 2. TROP GENERAL USE DOCUMENTATION 

SECTION 3. TROP UPDATE PROGRAM (UPD2TR) 
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SECTION 1. TRDP INTRODUCTION 
TABLE OF CONTENTS 



bb 1. WHAT IS TRDP 

& 2. TROP REQUIREMENTS 

70 3. OISCLAIMERS 

71 

72 H. CONTENTS OF A TRDP PflCK«GE 

73 

7H 5. THE TRDP PACKAGE 

75 

7b 1. HHRT IS TRDP 

77 

7B 

7S TRDP IS A NANE FOR A POP-U DIAGNOSTIC PACKAGE AVAILABLE 

60 ON nULTINEDI A, INCLUDES TR79F DIAGNOSTIC PACKAGE (9 TRACK 

61 MAGTAPE). 
82 

83 THE TRDP PACKAGES CONTAIN PDP-11 FAMILY DIAGNOSTIC PROGRAMS ON 

6M MEDIA OTHER THAN PAPER TAPE. TRDP PACKAGES HAVE THE FOLLOUING ADVANTAGES 

BS 

6B A. MORE COMPACT STORAGE MEDIA. 

87 B. EASY AND CONVENIENT MEANS OF LOADING PROGRAMS UNDER KEYBOARD CONTROL. 

88 C. MEANS ARE PROVIDED FOR UPDATING AND MODIFYING PROGRAMS. 

89 D. POSSIBLE TO SEQUENTIALLY RUN A SERIES OF PROGRAMS THROUGH USE 

90 OF THE "CHAIN MODE" FEATURE. (PROGRAMS MUST BE CHAINABLE). 
91 

92 
93 
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TROP REQUIREMENTS 


97 
96 
99 

18? 
ig 

104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 


2.1 


ALL TRDP PACKAGES REQUIRE: 




A. PDP-11 PRQCESSOR WITH AT LEAST IbK STORAGE. 

B. CONSOLE OEVICE 

C. TR79F DIAGNOSTIC PACKAGE MEDIA: 


2.2 


THE ABOVE REQUIREMENTS ARE FOR LOADING AND RUNNING DIAGNOSTIC PROGRAMS 
ALREADY STORED IN THE DIAGNOSTIC PACKAGE MEDIA. THEY ARE ALSO 

TO UPDATE A DIAGNOSTIC PACKAGE. THAT IS ADD NEU PROGRAMS OR NEW 






2.3 


OPTIONAL HARDWARE: 




A. BOOTSTRAP ROM FOR THE TR79F ^ ^ , 
IT MAKES LOADING THE TRDP MONITOR MORE CONVENIENT. 
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121 3. OISCLAinERS 

122 

1§ 3.1 THE TRDP PACKAGES HAVE BEEN DESIGNED FOR DIAGNOSTIC PURPOSES ONLY. 

125 THE TRDP SOFTUfiRE IS NOT INTENDED ^0 BE COMPATIBLE UITH ANY OTfCR 

12b PDP-11 FANILY SOFTUARE. ANY NON-DIAGNOSTIC USES OF THE SOFTWARE, OR 

127 USES OF THE SOFTUARE IN OTHER THAN THE MANNER DESCRIBED IN THIS 

l|fi OXUHENT ARE NOT SUPPORTED. 

130 3.2 THE TRDP PACKAGES ARE BINARY PACKAGES ONLY. THEY PROVIDE THE PDP-11 

131 FAMILY DIAGNOSTIC PROGRAMS IN THE MEDIA DESCRIBED. DOCUMENTATION 

132 FOR EACH OF THE PROGRAMS STORED IN A TRDP PACKAGE MUST BE OBTAINED 
lis SEPARATELY, FROM SOFtIJaRE DISTRIBUTION CENTER (SDC). HOWEVER. THIS 
13H DOCUMENTATION MUST BE OBTAINED AT THE SAME TIME AS THE PACKAGE. IN 
IX ORDER TO INSURE THAT THE DOCUMENTS AND THE PROGRAMS ARE AT THE SAME 
136 REVISION LEVEL. 

137 
138 
139 
140 
141 



t 



HOI 



• HfllN. flACYll 27(732) Ol-nflR-77 10:3S PAGE fa 

onoxfle.nii 



142 

1M3 4. CONTENTS OF A TRDP PflCKflGE 

144 

145 

1% THE BASIC PARTS OF A TROP PACKAGE ARE: 

147 

148 A. A CONTROL PROGRAM REFERRED TO AS THE "NONITOR". THE flOHITOR PROVIDES 

149 THE MEANS TO LOAD PROGRATIS UNDER KEYBOARD CONTROL. TO OBTAIN A 

150 DIRECTORY OF CONTENTS OF THE TROP fCDIUH (DISK, hAgTAPE, ETC). 
151 

152 B. TRDP UPDATE PROGRAM t2 (UPD2TR). A b.SK PROGRAM THAT PROVIDES A MORE COMPREHE 

153 SET OF COMMANDS THAT PROVIDE MORE CONVENIENCE AND EASE OF UPDATING 

154 THE TRDP PACKAGE. 
J 55 

15£> 
157 
158 
159 

160 5. THE TRDP PACKAGE 

161 

lb2 

lb3 THE TROP PACKAGE PROVIDES THE PDP-11 FAMILY DIAGNOSTICS ON 9 

IbH TRACK MAGTAPE (TR7SF). THE PACKAGE CONSISTS OF THE FOLLOWING ITEMS 

IbS THAT MUST BE ORDERED INDIVIDUALLY: 

Ibb 

lb7 MAINOEC-ll-OMOXA TRDP USER MANUAL (THIS DOCUMENT). 

IbB 

9 nAINDEC-ll-DM22H-A-MB9 TRDP-TRDP TR79F DIAGNOSTIC PACKAGE (9 TRACK). 
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101 

SECTION 2. TRDP GENERAL USE DOCUMENTftTION 

TfWLE OF CONTENTS 
LOADING PRXEOURES 



LOADING TRDP NONITOR 
USE PROCEDURES 

SETTING THE CONSOLE FILL COUNT 
OBTAINING A DIRECTORY 
LOADING AND RUNNING PROGRANS 

CHAiR pSIfiffi^COftSANOS 
MAKING A CHAIN 
RUNNING A CHAIN 
ERRORS 

TRDP RESIDENT MONITOR ERRORS 



APPENDIX A. TRDP RESIDENT flONITOR COHMANDS 
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211 

212 1.1 LOADING TRDP HONIT0R 

213 

214 

215 THE TRDP flONlTOR C9h BE LOftOED BY Bf1B873-Si, 

216 OR VIA A "TOGGLE-irr PROCEDURE. 

217 THE TOGGLE-IN PROCEDURE IS ONLY VALID FOR THE TR7qF. 
218 

21S 1.1.1 VIA BOOTSTRAP LOADER 

220 

222 A. tlOUNT THE TRDP TAPE ON DRIVE 0 AND MAKE READY 

223 B. REMIND DRIVE 0 TO "BOT" AND SET "ON-LINE" 
22M C. LOAD BNB873-S1 STARTING ADDRESS 17153& 

225 0. PRESS START 

226 E. GO TO 1.H.3 STEP A. 
227 



.riHiM. 

22S 

230 

231 

232 

233 

23S 

235 

23b 

237 

238 

23S 

240 

241 

242 

243 

244 

245 

2% 

247 

249 

249 

250 

251 

252 

253 

25b 
257 
258 
25S 



2b2 
2b3 
2b4 
285 
2bb 
2b7 
2be 
2bS 
270 
271 
272 
273 
27M 
275 
27b 
277 
278 
27S 
2S0 
281 
292 
283 
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1.1.2 VIP -TocaE-irr f»rocedure 



fi. MOUNT TRDP TAPE ON DRIVE 0 flNO MAKE RE«DY. 

8. REHIfC DRIVE 0 TO "BOT" AND SET "ON-LINE- 
DRIVE SHOULD BE a LOAD PIONT 

C. TOGGLE IN PROGRAM 

Q. STARTING ADDRESS AT LOCATION 10000 

E. UAIT JNTILL DRIVE S CPU HALT 

F. LOAD START ADDRESS AT LOCATION ZERO (0) PRESS START KE^ 



8 

0 

8: 

8 

0 
01 
01 



0000 

3014 
3020 
302M 
0028 



34 
0036 

0052 
H 



008H 00S004 



8 

0102 
3108 
3110 
010112 
010114 
010118 
010120 
010122 
010128 
010130 
010134 
010138 
010142 
010144 
010148 



012700 

011782 
012703 
012708 
000005 
004787 

8^12 
012710 

mi 

005011 

m 



184000 
184002 
184004 
184008 
077778 

000070 



OOOOOS 
5H 



8i?7 



4 



31 

00H787 
010405 
112524 
005205 
020513 

8^i^ 

032710 
001775 
032710 
001404 
032711 
001001 
000000 
000207 



174000 

000005 
000014 



000200 
100000 
011000 



START: 



BURST: 



IS: 
REED: 



3S: 

PACK: 



READY: 



TAPERR: 
RTN: 



MOV 

MOV 

MOV 

MOV 

MOV 

RESET 

JSR 

CLR 

MOV 

MOV 

^!? 

CLR 

MOV 

JSR 

CLR 

MOV 

MOV 

CLR 

MOV 

JSR 

MOV 

HOVB 

INC 

CMP 

BfC 

HALT 

BIT 

BEQ 

BIT 

BEQ 

BIT 

BNE 

HALT 

RTS 



1184000, RO 
1184002, Rl 
1184004 R2 
I184008.R3 
•77778,§P 

PC, READY 

K3.aR2 
«S,aRO 
PC.READY 
•26?aRl 

aRi 

PCl^Y 
R4 

R4JR3 

aRi 

•5,aR0 

PC, READY 
R4.R5 

(RS)+,(R4)* 
R5 

RS.aR3 

pa6k 

1200, aRO 

llOOQOO.gRO 

RTN 

tllOOO,aRl 
RTN 

PC 



;nT5AR 



LOl 
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28M 

28S 1.1.3 COmON PROCEDURE 

586 

287 

288 fl. THE MONITOR IS LOftDEQ FROM MEDIUM. 

29S B. THE MONITOR TYPES THE FOLLOWING MESSAGE ^^NO IS THEN REftOY 

2% TO PCCEPT KEYBOARD COMMANDS. 

251 XXXXX-X TRDP - TR79F MONITOR NNK RESTART; XXXXXX 

252 (HELP MESSAGE) 
2S3 

29S 

2« WHERE: NNK IS THE SYSTEM'S STORAGE UP TO 28K. 

2% XXXXXX IS THE MONITOR'S RESTART ADORERS. 

2^7 THE DOT (.) INDICATES THE MONITOR IS READY TO ACCEPT COHfWNCS. 

2<W C. THE HELP MESSAGE HAY BE ELIMINATED BY TYPING CTL C. 

300 D. GO TO SECTION 2. USE PROCEDURES. 

301 

302 

303 NOTE: <CR> MEANS PRESSING THE "RETURN" KEY ON KEYBOARD. 

30M 

305 
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307 2. USE PROCEDURES 

^ THE USE PROCEDURES THftT FOLLOW APPLY TO TRDP 
311 

313 2.1 SET THE FILL COUNT 



THE TTY OUTPUT ROUTINE OF THE UPOftTE PROGRflfl NORWLLY OUTPUTS 
14(8) FILLERCHflWCTERS RFTER R CfiffilSpE »«TURN. IH ORDCT TO INSURE 
THRT THE LMreTCTMINRL PRINTS COWECTLY, HOMEVftj. ONT&HIHflLS OTHER 



31H 
315 
31E> 
317 

m tKt thI lSsos the FnlER"cHflRflCT^"fl«'N^^ fltc 'rretihe' 

MS P'M'm^^f^fm&'m sssssm^ 

322 BE the first CONNRND ISSUED IN ORDER TO PROPERLY SET UP THE CONSOL . TYPE 

323 

32S F<CR> 

3% 000014 1 ;THE OOOOIM IS TYPED BY THE PROGRMI 

327 INDICATES THE CURRENT FILLER COUNT. THE 1 

328 INDICATES THE USER TYPED A FILLER COUNT OF 1. 
32S 

3X 

331 2.2 OBTAINING A DIRECTORY 

332 

333 

335 TO OBTAIN A DIRECTORY TYPE ONE OF THE FOUOHINC: 

335 

336 D<CR> TO OBTAIN DIRECTORY ON CONSOLE TERHINAL, OR 

337 

338 D/F<CR> TO OBTAIN SHORT DIRECTORY ON CONSOLE TERHINAL, 

339 

340 D/L<CR> TO OBTAIN DIRECTORY ON LIIC PRINTER. LIfC PRINTER 

3m NUST BE PRESENT ON SYSTEM. NO CHECK IS HADE FOR IT. 

3M3 THE DIRECTORY CONTAINS T« FOLLOUING INFORHATION: 

J45 FILNAN.EXT PROGRAN NANE AMD EXTENSION ASSIGNED. .BIN..BIC, 

3Mb AND .SAV. ARE TfC ONLY VALID EXTENSIONS FOR 

3M7 TRDP NOnItOR USE. 

1M9 

3MS NOTE; .BIN IS A BINARY FILE 

350 .SIC IS A CHAINABLE BINARY FILE 

351 .SAV IS A CORE INAGE FILE. 

352 LENGTH NUNBER OF BLOCKS USED. DECIMAL NUN6ER. (DISK). 
353 

35H START STARTING BLOCK NUNBER. OCTAL NUHEER. (DISK AND DECTAPE). 

355 _ 

356 DATE DATE UHEN PROGRAM WAS PUT ON MEDIUM. 
357 

3S8 
35S 
3bO 
361 
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3b3 2.3 LOADING AND RUNNING PROGRAMS 

364 

3b5 
366 

367 A. TYPE "R" fH> THE PROGRAM NAME (UP ro 6 CHARACTERS). DO NOT TYPE THE 

366 EXTENSION ( . WN. . BIC, > • 

365 THIS UILL LOAD AnO RCiN THE PROGRAM. TO JUST LOAD THE PROGRAM 

370 TYPE "L" AND THE PROGRAM NAME. ONCE LOADED TYPING A "S" 

371 UILL START THE PROGRAM. 
372 

373 B. DEPRESS THE CTL ATC C KEYS. 

375 IF A TYPING ERROR IS MADE. DEPRESS THE CTRL AND C KEYS AT SAME TIME. 

376 A DOT (.) UILL BE TYPED. AETYPE "R" AND THE PROGRAM NAME. 
377 

378 C. THE DESIRED PROGRAM IS LOADED, A DOT TYPED, AND, 
37S 

THE pr6grah name uas 

^ &DP> UITH AN ALTHQDE (>«RACTER. OR 

383 3. TlcnONITOR UAITS FOR ANCTIcR c6mMAND. THE PROGRAM JUST LOADED 

38M MUST BE STARTED MANUALLY BY TYPING S PROGRAM NAME <CR> . 

385 

386 0. TO LOAD ANQT«R PROGRAM AFT0 RUNNING THE PREVIOUSLY LOADED PROGRAM, 

387 RESTART TIC NONITORAT THE RESTART ADDRESS, OR RELOAD THE MONITOR 
386 AS DESCRIBED IN SECTION 1. 

389 

3% E. POSSIBLE ERRORS ARE DESCRIBED IN SECTION 3. 

391 

392 CAUTION: UHEN LORDING DIAGNOSTICS THAT TEST THE TRDP MEDIUM CARE MUST 

393 BE TAKEN TO INSURE THAT THE MEDIUM IS NOT ACCIDENTALLY 

39H DESTROYED. THAT IS THE REASON THAT THE MEDIUM MUST BE URITE- 

395 LOCKED. REMOVE IT IF IT IS DESIRED TO TEST THAT DRIVE. 

3% 

397 

398 
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i 2.4 CHAIN HOOC OPWTla. 

402 

Hia CHftIrt H00£ OPERRTIOW COWSISTS OF THE aOUENTI«- gXECUTIOh OF PRQGRflfIS 

<40>4 HlTNOUTOPdMTOR iHTERVENtZOri. OtCY PROSSWS THAT HAVE KEN HOOIFIEO 

405 TO RUN IN CHRIN NOOE CflN BE CHAirCO. CHAINA8LE PROGRflnS ARE 

409 TO RUN CHRIN HOOE. THE TRDP MONITOR REQUIRES ft FILE IfCICflTINC 

410 THE PROCRRHS TOTON. RND THE NUMBER OF TINES EACH PROGRRH NUST 

411 EXECUTE BEFORE 60IN& Oh TO THE NEXT PROGRRN IN THE TABLE. 
412 

413 A CHRIN FILE HRY BE GENERATED BY USING THE XTECO TEXT EDITOR, 

414 RND THE USCT NUSTTuT A .CCC EXTENSION ON THE CHRIN FILE. 

415 TO SUNNRRIZE: 
416 

417 1. CHRIN NODE RUNS CHRINRBLE PROGRRNS Ott.Y. (.BIC EXTENSIONS). 

418 2. A CHRIN FILE INOICRTES THE PROCRRHS TO RUN AND THEIR PASS COUNTS. 

419 3. ONLY PROGRRnS RESIDENT ON THE SRNE NEOIUN DRIVE CRN BE CHAINED. 

420 4. THE CHRIN FILE HJST BE ON THE SRNE NEDIUM WITH R .CCC EXTENSION. 
421 

422 NOTE: THE .CCC EXTENSION INDICRTLS R CHRIN FILE 
423 

424 CHRIN NODE IS ENTERED BY TYPING: 

42S 

426 C FILENRnE<CR> (UKILE IN MONITOR NODE). 

427 UHERE: 

428 C IS THE -CHRIN- CONNRND 

429 FILENRME IS THE VRLUE OF THE ASCII FILE THAT CONTAINS THE HONITOfi 
4X COHHRNDS TO BE EXECUTED. THE FILE NUST HRVE R -.CCC"EXTENSION. 
431 

43? 
433 



COi 



.nfllN. nftCYU 27(732) 

onQXAB.mi 

M34 

^ 

H3B 

43S 
440 
441 
442 
443 
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445 
4% 
447 
448 
44g 
450 
451 
452 
453 
454 
455 
45b 
457 
456 
459 
HbD 
%1 
4£,2 
463 



2.4.1 HAKING A CHAIN ASCII FILE 

THE CHAIN ASCII FILE NAY BE CREATED BY RUNNING TfC XTECO PROGRAM AND 
USING THE TEXT EDITOR TO CREATE THE ASCII CHAIN FILE. THE CHAIN FILE 
NAY CONTAIN ANY OF THE COHNANDS SUPPORTED UNDER THE TROP NONITOR. THE 
COmANDS IN THE ASCII FILE ARE EXECUTED IN THE ORDER IN WHICH THEY ARE 
ENTERED AND RUN AS A BATCH NODE. 
EXAMPLE OF A CHAIN FILE; 

THIS CHAIN FILE EXERCISES THE XY2 PROCESSOR UITH T1-T13. . 



k DOAA/1000 
R OOBA/1000 
DOCA/1000 
DQOA/1000 
DGEA/1000 
OGFA/1000 

OOJA/IOOQ 
OOKA/IODO 
OOLA/IQOO 
DONA/ 1000 
DONA 
S/1000<CR> 
C CPU 



RUN Tl 1000 TIHES<CR> 
RUN T2 1000 TIHES<CR> 
RUN 13 ' 
RUN T4 



IQQO TIHES<CR> 
1000 TiHES<CR> 
RUM T5 1000 TIfCS<CR> 
RUN Tb 1000 TIHES<CR> 
RUN 17 IQQQ TI{CS<CR> 
RUN TB 1000 Tirts<CR> 
RUW TS 1000 TINES <CR> 
RUN TIO 1000 TIfCS<CR> 
RUN TU 1000 TIHES<CR> 
RUN T12 1000 TinES<CR> 
LOAD T13<CR> 

START IT, RUN 1000 TIPES<CR> 
RESUBMIT CHAIN FILE AGAIN. 
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do; 



2.4.2 RUNNING A CHAIN 

TO EXECUTE A CHAIN FILE THE USER TYPES; 

H70 C FILNAM<CR> OR 

471 C FILNAH/QV<CR> 

i \t 'j^'i^ixv^'m.mw^ci"^, TO 

47S EXECUTE EACH PROGRfM. IN THE SECOND CASE THE PASS COUNT 

478 THE CHAIN FILE TO BE EXECUTED MUST HAVE AN EXTENSION OF .CCC. 

4U THE CHAIN FILE AND THE OBJECTIVE PROGfiATIS TO BE RUN NUST RESIDE IN 

481 THE SANE TRDP NEOIUN AND NUST BE MOUNTED ON DRIVE 0 OF TRDP DEVICE 

4^ UHEN IN CHAIN NODE SUITCH REGISTER OR SOFTHARE SWITCH REGISTER SHOULD BE SET TO 000000. 

4K THE TRDP MONITOR HILL TYPE EACH COMMAND THAT IT EVALUATES AND THEN 

4Bb PROCEED TO EXECUTE IT. 

W<33 UHEN THE LAST COMMAND OTHER THAN ANOT^CR "C" COMMAND HAS BEEN EXECUTED 

494 THE TRDP MONITOR TERMINATES CHAIN MODE AND TYPES A DOT(. ), 

4« READY TO ACCEPT ANOTHER COf«AND FROM THE CONSOLE. 
4% 

4<)7 IF THE USER WISHES TO TERMINATE CHAIN MODE BEFORE ITS NORMAL TERN! NAT I ON 

4« HE NAY DO SO BY REPEATEDLY TYPING CTL C (tC) AT THE CONSOLE UNTIL 

4«« THE nONITCR ACCEPTS IT AT THE END OF fl PROGRAM PASS. 

50Q 

501 

502 



EOS 
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S03 
BOH 
505 
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3. ERRORS 



508 
509 
510 
511 
512 
513 
514 
515 
516 
517 
516 
519 
520 
521 

523 
52M 
525 



528 
529 
530 
531 
532 
533 
53H 
535 
536 
537 



3.1 TROP RESIDENT MONITOR ERRORS 



INVCMD/SU 

OEVERR 

EOfI 

INVnOR 

CKStlER 
POFLO 

INVNRM 
NEXFIL 



INVALID COnnANO ANO/OR SUITCH. 
JUST GIVEN. 



CHECK COrtlANO 



DEVICE ERROR ON EITHER INPUT OR OUTPUT DEVICE. 
CHECK THAT OUTPUT DEVICE IS HRITE-ENABLED. 

END OF NEOiyn. OCOJRS DURING INPUT OPERATIONS 
MCN THEn»ROCRA« <iTTE«PTS TO INPUT AND THE FILE 
IS OT ANEND. SERIOUS PROBLEH. FILE IN STOR- 
AGE IS PROBABLY UIKD OUT. 

FSlSBPf^ih^ [^ItF gJN WIHIN.EXISTING 



UPDATE PROGRAM. 
CHECK5UN ERROR DURING 



MUST NOT BE UITHIN 



•LOAD- COMMAND. 



PROGRAM TOO LARGE TO LOAD UITHIN EXISTING CORE 
SPACE. 

INVALID CHARACTER TYPED FOR FILE NAME. 

NON-EXISTENT FILE. IF IN CHAIN MODE 
THE PROGRAM TO BE RUN DOES NOT HAVE 
.BIC EXTENSION. 
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538 

53S 
540 
541 
542 
543 
544 
545 
5% 
547 

P 

550 
551 
552 
553 
554 
555 
55b 
557 
558 
559 
5&0 
561 
SbB 
Sb3 
584 
5&5 
568 
587 
586 
589 
570 
571 
572 
573 
574 
575 
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fiPPENDIX P. TRDP RESIDENT MONITOR COtlflftNDS 



F<CR> 

D<CR> 

D/F<CR> 

D/L 

D/L/F 

R COPY 

R FILENflnC 

L FILENAME 

S FILENWC 

S ROOR 

C FILENRHE 

C FILENRHE/OV 

E 0<CR> 

E 1<CR> 



SET CONSOLE FILL COUNT. 
DIRECTORY ON THE TTv CONSOLE. 
SHORT DIRECTORY ON THE TTY CONSOLE. 
DIRECTORY ON THE LINE PRINTER. 
SHORT DIRECTORY ON LINE PRINTER. 
STARTS THE COPY PROGRAM. 
STARTS irCICATED PROGRAM. 
LOADS DESIRED PROGRAM. 

STARTS DESIRED PROGRAM UHICH UAS LOADED UNDER "L" COMMAND. 

STARTS PROGRAM AT SPECIFIED ADDRESS. 

RL^6 DESIRED CHAIN TABLE. 

RUNS DESIRED CHAIN IN QUICK VERIFY. 

ENABLE DRIVE O(TADP) 

ENABLE DRIVE l(TADP) 
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577 SECTION 3. TROP UPDATE PROCRflMS 12 {UP02TR) 



578 
579 

580 TABLE OF CONTENTS 

581 

582 

583 1. ABSTRACT 

58M 

585 2. REQUIREMENTS 

586 

587 3. LOADING AND STARTING PROCEDURE. 

588 

589 H. CONNAND DESCRIPTIONS 

590 

591 5. ERRORS 

592 

593 6. UPDATING TROP NEOIA 

59M 

5% 7. HELP ASCII REFRENCE FILE 

597 

598 APPENDIX A. UPD2TR COHNANDS 

599 APPENDIX B. PERIPHERALS SUPPORTED BY UPDATE PROGRAMS 
bOO 

e>01 APPENDIX C. PROGRAN NAHING CONVENTIONS 

b02 

b03 

60M 1 . ABSTRACT 
b05 ~ — 

bOb 

&07 EACH TRDP PACKAGE CONTAINS PROGRAN CALLED UPD2TR.BIN. 

b08 THIS PROGRANS IS USED TO ADD. DELETE, RENAHE. OR PATCH PROGRAMS ON TROP 

£•09 PACKAGES, ATC IN GENERAL, PR6vI0E flU NAINT&MCE SERVICES. 

blQ 

611 UPD2TR IS A 8K PROGRAN UHICH RELOCATES ITSELF TO THE TOP 8K OF 

bl2 MEMORY. LEAVING LOWER STORAGE FREE FOR OTHER PROGRAMS. IT 15 

bl3 CAPABLE OF PERFORMING OPERATIONS ON ALL TRDP MASS STORAGE DEVICES. 

blH 

bl5 

bib 

bl7 

bl8 

bl9 

b20 
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b21 

b22 3. LOADING AND STARTING PROCEDURE 

b23 



bk UP02TR IS LOADED VIA THE TROP MONITOR BY TYPING R IJPDSTRXH. . 

feat ONCE LOADED, IT OUTPUTS THE FOLLOWING MESSAGE: 

Us XXXXX-X - TRDP UPDATE PROCRAM 12 2l-FEB-7b 

b29 DATE: 

b30 

&32 TYPE THE DATE ACCORDING TO FOLLOWING FORMAT: 
b33 

b3S 0ATE:DO-HMM-YY<CR> 

b3b 00 IS T« DAY OF T« MONTH. MMM IS JAN, FEB. MAR. APR. HAY 

fe37 JUN, JUL, AUG, SEP, XT, n6v, DEC, AND YY IS BETJcEN 70 Ah6 9<3. 
b38 

e>3S TEST IS MADE TO HAKE SURE NO MONTH HAS MORE THAN 31 DAYS. BUT 

bH3 THE PROGRAM MILL TYPE BACK THE DATE FOLLOWED BY: 

b4M 

b45 PROGRAM RELOCATED TOrYYYYYY ; INITIAL AOOR WHERE PROGRAM RELOCATED TO. 

b% RESTART: XXXXXX ;UPOl RESTART ADDRESS. 

b47 * \* INDICATES READY FOR KEYBOARD COMMANDS. 

E>4B 

SHS 

E>50 

bSl 4. COMMAND DESCRIPTIONS 

652 

b53 

LCli 

bSS 4.1 IN THE COMMAND DESCRIPTIONS THAT FOLLOW. AN INDICATION IS PROVIDED 

b56 AS TO THE AVAILABILITY OF THE COMMAND UNDER UPD2TR. 

b57 

bse 

bbO 4.2 THE FILL COMMAND (UP02TR) 
bfel 

bb2 

bfeS THE CONSOLE TERMINAL OUTPUT ROUTINE OF THE UPDATE PROGRAM NORMALLY OUTPUTS 

870 

b7l FILL<CR> 
b72 

b73 000014 1 ;THE 000014 IS TYPED BY THE PROGRAM AND 

874 INDICATES THE CURRENT FILLER COUNT. THE 1 

b75 ; INDICATES THE USER TYPED A FILLER COUNT OF I . 

bTb 
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£.77 THE FILLER COUMT SHOULD BE SET TO fi 1 TOR flSR33 flNO ftSR35 TERTIINfiLS. 

Ztu FOR OTHER TERMINflLS^ 5^ THE NUMBER TO UHflTEVER PRODUCES CORRECT 

m PRINTINGVteR ScWfRlACE RETUftM, WITHOUT UNDUE DELftY. 

Hi 4.3 THE -CLR" COrmC (UPD2TR) 

b82 

THE "CLR" COnnftNO IS USED TO CLEAR TO ZEROES ftLL CORE STORAGE BELOW 

thI update PROGRan. n is provided in case the user uishes core 

b% STORAGETO be -zeroed- prior to loading a program. TYPE: 

tiBB CLR<CR> 

|qO THE program RESPONDS WITH « 

b« 4.H LOAD COIfllAND (UPD2TR) 

b9M 

b% THE LOAD COnWWD IS USED TO LOAD FILE3 STORED IN ABS FOWIAT. 

b* FILEsSlTHEXTENSIONS OF .BIN, .BIC. OR OTHER EXTENSIONS KNOUN 

b98 TO INDICATE ABS fORIAT}. 

700 LOAD OEV: FILNAH.EXT ;CO«MArC FORMAT 

702 IF THE DEVICE »«S NO DIRECTORY, THEN THE FILE NAME AND EXTENSION 

703 SHOULD BE OHITTEO. 

TK LOAD PR: ilSE« COMMAND TO LOAD FROM PAPER TAPE. 

7K XFRADR: 000050 COAE: 00d000,017b70 

707 » 

701 XFWW?: INDICATES THE STARTING ADDRESS OF THE PROGRAM LOADED. IF 
710 IT IS 000001 OR ODD, nC PROGRAM IS NOT SELF-STARTING. 



710 

71? CORE: LEFT NUMBER INDICATES T« LOWEST LOCAIION LOADED INTO^DURING 

713 THE LOflD?THE RIGHT NUMKR INDICATES TtC HIGHEST LOCATION 

714 LOAolDJtNTO DURING THE LOAD. THE LEFT AND RIGHTrt«^ 

715 IN&FECT INDICATE THE CORE LIHITrOF THE PROGRAM. 

717 H.S DUMP COMMAND (UP02TR) 

71! THe'hSoRy'cONTENTS CAN BE WRITTEN TO A TROP MEDIUM IN AOS FORMAT BY THE 

720 DUMP COMMAND. 

721 

722 DUMP OEV: FILNAM.EXT ;COHMAND FORMAT 



724 PROCESSING STARTS FROM PROGRAM'S LOU CORE LIMIT AND PROCEEDS TO 

7S aSTINCLUOES THE PROGRAMS HIGH CORE LIMIT. 

727 lOUMP DKO:XXX.BIN ;DUMP PROGRAM ONTO DKO:. CALL IT XXX. BIN 

728 *01P DKO: 
72S 

731 entry!'''' FILNAM .EXT DATE LENGTH START 

732 000001 XXX .BIN 2b-AUG-72 17 000105 
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733 000002 2 2-ftUG-72 12C 000172 

73S 000003 3 2-«UG-72 12C 00020fc 

73S FREE FILES: HHS 

73b 

737 • 
738 
73S 

740 H.b THE -XFR- COrmC (UPD2TR) 



741 
742 

744 

745 ftis dCscriMd'uhpb "lQSQ cottwrtr. the lo«d routine types.- xfroor ;xxxxxx 

7% INOICATINC HHETHR A PROdwi IS oA IS NOT SELF-STARTING. THE USE OF "XTR" :c 

i ^> aoooso I Wi^m^iRf ^"m. no«o is t« 

7S0 ;NEU XFR ROORESS ENTERED BY THE USER. 

tII NOTE: DIflGNOSTIC PHOGRflHS ARE PURPOSELY NftOE NOT SELF -START INC. 
753 

754 4.7 THE -START- C0H1AND (UP02TR) 

755 

757 THE -START- COIflAND IS USED TO BEGIN EXECUTION OF A PROGRAM IN CORE. 

75? START<CR> ;USED TO START A SELF-STARTING PROGRAfl. 
7S0 

7bl START «)R<CR> ;USED TO A START A PROGRAM AT A SPECIFIC LOCATION. 

7b3 NOTE: IF THE COMMAND START<CR> IS GIVEN FOR A NON-SELF-START PROGRAM, 

7b4 THE PROCESSOR MIL TRAP OUT WITHOUT AN ERROR MESSATE. 

765 

7bb 4.8 THE SAVE CONNfM) (UP02TR) 

7b7 

768 

7faS THE CONTENTS OF CORE ARE HRITTEN_ONTO THE OUTPUT DEVICE AS A SINGLE 

77D BLOCK OF DATA. STARTING AT LOG 000000 AND PROCEEDING TO THE HIGH 

773 VALID EXTENSION FOR SAVED PROGRAMS IS .SAV. 

775 THE ONLY CURRENT USE OF THE SAVE COMMAND IS TO _ 

77B CORE IMAGE FILES 

77«3 NOTE: .SAV IS A CORE IMAGE FILE. 

780 

781 SAVE DEV: FILNAM.EXT ; COMMAND FORMAT. 
782 

783 «SAVE DKO: UPDATE. SAV 

794 «OIR DKO: 
785 

78t» 12-JAN-7b 
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Tf€ GET COMtlftNO PLACES THE "SflVED" PROGRAM INTO CORE STARTING AT LOC 000000 



7S0 QQQ003 UPDATE .SAV 2t>-AUG-72 12C 0002M? 

791 FREE FILES: 4M5 

792 » 
793 

79M 4.9 THE GET COHMAND (UP02TR) 

79S 

799 GET DEVrFILNAM.EXT 

BOO 

801 tC 

802 ftGET DKO: UPDATE. SAV 

803 * 
DM 

05 NOTE: SAVE CORE IMAGE FILES (.SAV FILES) ARE NO 

806 LONGER IN USE. THE "GET" COItlAND IS NO 

07 LONGER VERY USEFUL. IT HAS SEEN LEFT AS 

08 THE CONPLEHENTARY CONNAND FOR THE SAVE CONNANO. 
809 



H.IO THE NOO COftMND (UPD2TR) 



13 

IM ONCE A PROGRAN IS LOADED IT CAN 8C PATCHED BY THE NOO COfWANO. 
15 

17 NOO ADR CAUSES UPDATE TO PRINT THE FOaOHING: 

§19 ADR CONTENTS OF AOR. 
820 

821 AND WAITS FOR USER RESPONSE. 
822 

823 THE |£ER NAY TYPE IN AN OCTAL NUMBER AND A TERMINATOR. OR JUST 

82M A TERMINATOR. 

825 

82b IF A NUMBER IS TYPED, IT IS USED AS THE NEU CONTENT OF AOR. 
827 

828 THE TERMINATOR CAN BE EITHER A CARRIAGE RETURN OR A LINE FEED. 

829 CMRIaS RETURN TAKB TIC[§0CIMM BACK TO COMMAND MODE. MJCREAS 

830 T»C LINE FEED CAUSES THE NEXT UORD (AOR+2) TO BE OPENED FOR 

831 MCOIFICRTION 
832 

833 «M00 50 

83M 000050 000005 3 <LF> 

835 000052 012737 4 <LF> 

83b 00005H 0003H0 5 <CR> 

837 IMOO 50 

838 QOOKO 000003 <LF> 

839 000052 OOQOOM <CR> 
8M0 * 

841 

842 THE HOD COMMAND UILL NOT ALLOU THE USER TO GO BEYOND THE PROGRAM'S 

843 PROTECTION LIMIT, AN "INVCOR" ERROR UILL OCCUR. 
B4M (SEE SECTION 4.13) 
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845 

8S| 4.11 THE CORE COMTIAND (UP02TR) 

849 THE CORE COriTIRND CRUSES THE LOWER RNO UPPER lIHITS OF THE PROGRRTI 

850 IN CORE TO BE TYPED: 



NUHKR IS THE LQICR CO^LIfllT. 
•RIGHT NUMfiER IS THE UPPER CORE LIMlt. 



WHERE ROR IS THE NEU HIGH CORE LIHIT. RECOttCW THAT 
RQORESS K EVEN, JUT MfiT BE HIG»CR THRN TfC LOUEP 
LiniT, RNO MUST BTLOin THRN STRRT OF UPDATE PROGRRTI. 



851 

852 tCORE<CR> 

853 000000,014776 
854 
855 

aSfc 4.12 THE -LOCORE" COHNRND (UP08TR) 

857 

856 

85S THE -LOCORE" COHNRND IS USED TO CHANGE THE LOWER LIMIT OF THE PROGRAN IN CORE: 

8b0 

8bl tLOCORE ADR<CR> ;WI€RE ROR IS THE NEW LOW CORE LINIT. IT IS RECOHNENDE:] 

862 ;THAT ADDRESS BE EVEN. 

8b3 

864 4.13 THE "HICORE- CONNAND (UPD2TR} 

865 

866 

867 T»C "HICORE- CONNArC IS USED TO CHANGE T»C UPPER LINIT OF THE PROGRAN IN CORE: 

868 

869 ftHICORE A0R<CR> 

870 
871 

872 

873 TYPICALLY, TH| HICORE CONHAND IS USED TO RESERVE AN AREA FOR PATCHING 

874 A PROGRAn! ThI UPDATE PROGRAN HIU NOT AUOU HOOIFICATION OF CORE 

877 

879 4.14 THE DIRLP AND OIR COHHAMOS 

880 

861 

882 OIR (UPgeTR) 

883 DIRLP CUPOaTR) 

884 lOIRLP OEV: ; CONNAND FORNAT 

885 CONHAND EXAHPLES 

886 UPD2TR ONLY 

— — — 

888 «DIR OEV:«.BIN : GIVES A DIRECTORY OF AU FILES 

889 ftlTH A ".BIN- EXTENSION. 

890 »DIR DEV:#.BI' ; GIVES A DIRECTORY OF ALL FILES 
B9I AlTH AN EXTENSION BEGINING WITH 

892 "BI" Arc ANY QT>CR CHARACTER 

893 SUCH AS BIN OR BIC. 

894 OIR DEV:ZTC'".BI' :CIVES A DIRECTORY OF PU FILES 

895 filTH THE FIRST THREE CHARACTERS 
8% OF THE FILENAME flEING "ZTC" 

897 AND HAVING AN EXTENSIOT^ 8EGI4ING 

898 WITH -81". EXAMPLES; ZTCA.8IN, 

899 ZTCB.BIN, ZTCC.8IC. 

900 NOTE: AT THE END OF THE DIRECTORY THE FREE FILES AND FREE BLOCKS WILL BE 
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901 INDICATED ONLY ON RANOON ACCESS DEVICES. 

^ NOTE: DIR IN UPDATE 11 GIVES ONLY THE SHORT DIRECTORY (NO LENGTH, HO START). 



«5 

907 DIRLP CAUSES THE DIttCTORY OF DEV: TO PRINTED ON LlfC PRINTER. IF 

<310 EXISTENCE. THE PROGRAH UILL PROBACY TRAP. 

•311 
912 

llH eiTftYl " FILNAN .EXT DATE LENGTH START 

qi5 000001 1 2-AUG-72 14 OOOIOS 



«QIR OKQ: 

MfT' 



31^ 818! ! tmi m m. 

SIB QQQQ04 5 2-AUG-72 12C 000222 

giS FRETfILES: 444 

S2Q t 
921 

922 LENGTH IS THE NUNKR OF BLOCKS (10) THE FILE OCCUPIES. A "C" AFTER 

«3 THE FILE LENGTH INDICATEr THE FILE IS CONTIGUOUS. 

Ms START IS T»C AOOR OF FIRST BLOCK OF FILE. OCTAL NUNBER. 

92E> DATE IS T»€ FILE CREATION DATE. 

927 

926 

929 4.15 THE DELETE COItlAND (UP02TR) 

930 

931 

932 Oa OEV:FILNAH.EXT 
933 

934 CAUSES THE FILE NANED TO BE DELETED FRON THE DIRECTORY. 
935 



1 



938 

939 12-JAN-7b 

940 BJTRVI FILNAN .EXT DATE LENGTH STAR^ 

941 000002 2 2-AUG-72 12C 300172 

942 000003 3 2-AUG-72 12C 000206 

943 000004 5 2-AUG-72 12C 000222 

944 RK FILES: 444 

945 » 

9% 4.1b THE ZERO CONNANO (UPD2TR) 

947 

949 ZERO DEV: 

ill DESTROYS THE DIRECTORY. AS FAR AS UPDATE IS CONCERNED. THERE IS 

952 NOTHING ON THE DEVICE. THIS SHOULD BE DONE ON fl BRAND Nt'U TAPE 

953 OR CARTRIDGE SINCE UPDATE USES THE ZERO COH«<W€ TO RESERVE SOHE 

954 ROOH FOR USE BY THE TRDP NONITOR. VALID FOR ALL ruSS STORAGE DEVICES. 
955 

956 »ZERO DKO: 
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9S7 
%8 

t? 

%2 
%3 
%M 
SbS 

^ 

%8 

%9 
970 

^ 

973 
97M 
975 

978 
979 
980 
9B1 
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N02 



ftOIR DKO: 
26-MJG-72 

FILNAH.EXT 

FREE FILES: 448 
t 



LENGTH START DATE 



4.17 THE BOOT 



4.17.1 BOOT DEV: 



(UP02TR) 



LOC 000000 TO START THE BOOT LOADER. 



EXAMPLE: 

BOOT DKO:<CR> 
BOOT I1T0:<CR> 



;B00TS IN THE RKDP MONITOR. 
;B00TS IN THE TRDP MONITOR. 



4.17.2 SAVM DEV: (UPD2TR) 

CAUSES THE FIRST 4K TO BE HRITTEN IN .SAV FORMAT (CORE IMAGE) 
DEVICE AS A CORE IMAGE THAT IS BOOTABLE. 

THE SAVn COMMAND IS VALID ONLY ON RANDOM ACCESS DEVICES. 

NOTE: SAVM IS NOT A DIRECTORY ENTRY iT WILL NOT SHOW 

ON DIRECTORY. 

4.18 THE RENAME COMMAND (UPD2TR) 

«REN OEV:NEUNAn.EXT«>OEV:OLONAM.EXT 

RENAMES THE OLD FILE. THE DEVICES MUST BE THE SAME. NOT ALLOWED 
ON MAGTAPE OR CASSETTE. 

ffOIR DKO: 

iNTl}?!*^^ FILNAM .EXT DATE LENGTH START 
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1013 
IQIH 
lOlS 
iOlb 
1017 
1018 

ion 

1020 
1021 
1022 
1023 
'Q2H 
1025 
1Q2B 
1027 
1028 
102*} 
lOX 
1031 
1032 
1033 
103H 
1035 
<036 
1037 
1038 
103S 
lOHO 
lOHl 
lOMt 
10M3 
lOSH 
10% 
10% 
10S7 
10% 
10S9 
1050 
1051 
1052 
1053 
105H 
1055 
10S6 
1057 
1056 
1059 
lObO 
1061 

1063 
1064 
1065 

1066 
I0fc7 
1068 



000001 flSO . 123 

FREE FILES: W 



•fiEN 0K0:123.flSIH)KO:ASO.l23 

iOIR DKO: 

12-JflN-76 

EffTRYl FILNflfl .EXT 

000001 123 .ASO 

FREE FILES: HM7 
« 



2b-flUC-7b 



IbC 



000105 



2b-MiG 



LENGTH 
IbC 



STftRT 
000105 



4. IS PIP COHMflND 



(UPD2TR) 



PIP IS USED TO COPY A LINKED FILE FROM PNY CZ^ICE THAT CftN INPUT 
TO RHY DEVICE THRT CRN PERFORM OUTPUT OPERATIONS. FILE OflTfl IS 
NOT CHECKED FOR FORflflT OR CHECKSUMS. 

PIP DEVl:FlLN«H.EXT«-DEV2:FILNfl«.EXT 



PIP PP:«^: (COPIES PflPER TAPE) 
•PIP DK0:123.456<PR: :PRPER TAPE TO DISK 

fPIP PP:<DKO: 123.456 

•DIR DKO: 



;DISK TO PAPER TAPE PUNCH. 



12-JAN-76 
ENTRY! 
000001 



000002 
FK£f 



ILES: 4% 



FILNRN 

123 

123 



.EXT 
.ASO 
.4S6 



QATE 

26-AUC-72 
26-AUG-72 



LENGTH 
IbC 
3 



START 

000105 

000125 



THE USER SHOULD HAKE SURE THAT THE OUTPUT FILE NAME DOESN'T EXIST 
ALREADY ON THE OUTPUT DEVICE DIRECTORY. 

PIP DKO:A«-DKO:A ; IS A NO NO. 

DELOLD ; CAUSES THIS ERROR. DELETE OLD FILE 1ST. 

PIP HAS OTHER USEFUL FEATURES: 

PIP PP:«-PR: COPIES A PAPER TAPE. 

IMPORTANT!!! 

R PROGRAM THAT HAS BEEN "PIPPED" TO A TROP DEVICE 
MUST BELOAOED IMMEDIATELY VIA T« "LOAD" COMMAND 
TO INSURE THAT NO ERRORS HRVE OCCURRED DURING THE 
-PIP^^CWMAHO AS THE PIP COMMAND DOES NOT CHECKSUM 
INPUT DATA! 



4.20 THE "FILE" COMMANDS 



(UP02TR) 



C03 
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1071 UP02TR INCLUDES A GROUP OF COftWNDS WHICH CAN EXECUTE OM MULTIPLE 

1072 FILES UITHOIJT REQUIRING THE NflflE OF EACH FILE TO BE INDIVIDUflLLY 

1073 LISTED IN THE COfmC STRINGS. THESE ARE THE "FILE" COmflMDS/^ 
107M INaUDING FILE. FILEF. FILEL. FILEC. FILED. RHD FILET. FOUO6ING 
1075 THIS GENERAL Q^SCRIPTtON, TH^IR DIFra^NCE^ UILL BE INDIVIDUALLY 
1376 EXPLAINED. N0T| THAT THE "FILE" COTtlAtOS IN GENERAL, CAN NOT BE USED 
1077 WITH NON-DIRECTORY DETICES (SUCH AS PR, PP, LP). 

1078 

1079 T« -FILE- COMMANDS RECOGNIZE THO SPECIAL CHARACTERS IN THE FILE NAME 

1060 AND EXTENSION. THESE CHARACTERS. . 7H|. ASTERISK («) AND THE OUESTION- 

1081 MARK (f) AUOU A SINGLE NAME TO REFERENCE SEVERAL FILES. 
1082 

1083 NOTE THAT FILE NAMES ARE ALUAYS RECORDED AS HAVING b CHARACTERS. 

108M AND EXTENSIONS ALUAYS HAVE 3 CHARACTERS. THEY ARE LEFT- JUSTIFIED 

1085 WITH TRAILING BLATiG ADDED, AND THE BLANKS ARE PART OF THE NAME. 
108b 

1087 BECAUSE THE "FILT COMMANDS CAN HATCLE SEVERAL FILEb PER COMMAND 

1090 DIRECTORY IS ^TOCm IN THE CASE OF DISK OR OECTAPE. OR T>€ BLOCKS 

1051 ARE SCANNB) IN THE ^.OF C«SETTE OR NftCTAPE). THE-f ILE" COMMAND 

1052 IS ABORTm^ AND THE^R ISIwflNTEO. IF A 0EVI6e ERROR, CHECKSUM 

1093 ERROR, OR END OF MEDIUM ERROR OCCURS WHILE READING A FICe (FILEL, 

1094 FILEG! AND FILET) THE ERROR IS REPORTED AND T»CN PROCESSING 

1095 OF TH^ COMMAND IS CONTINUED. 
10% 

1097 THE -FILE- COMMANDS LIST THE DESCRIPTIVE INFORMATION ABOUT EACH 

1098 FILE AS IT IS PROCESSED. INCLUDING FILE NAME, TRANSFER ADDRESS, 

1099 AND LOCORE ATO HICORE vAlUES. THE /N AND /LP SWITCHES ARE INCLUDED 

1100 TO ALTER THIS IF OBIRED. 

1102 4.21 THE -ASTERISK- CONSTRUCTION 

1103 

1104 

1105 THE -ASTER.^ CONSTRUCTION PERMITS REFERENCE TO ALL FILES HAVING A 

110b DESIRED EXTD€ION (ANY FILENAME). TO ALL FILES HAVING A DESIRED 

1107 FILENAME (ANY EXTENSION). OR TO AlL FILES ON A DEVICE. ITS USE IN 

HOB THE FILENAME POSITION NEAt^ "ANY FILENANE" AND IN THE FILE EXTENSION 

1109 POSITION MEANS "ANY EXTENSION". 
1110 

nil TO REFER TO ALL FILES HAVING A DESIRED EXTENSION (ANY 

1112 FILENAME), AN ASTERISK IS TYPED FOR THE FILENAME: 

1113 

1114 DKO:».OBJ MEANS PLL FILES ON DISK 0 WITH 

1115 A .OBJ EXTENSION 
1116 

1116 TO REFER TO ALL FILES UITH A DESIRED FILENAME (ANY EXTENSION), 
1119 AN ASTERISK IS TYPED FOR THE EXTENSION: 

1120 

1121 0K0:UPD2TR.» MEANS ALL FILES ON DISK 0 MITH THE 

1122 FILENAME UPD2TR, SUCH AS UPD2TR.P11. 

1123 UPD2TR.LST, AND UP02TR.DOC 



Hi 
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iiil TO REFER TO ftLL FILES ON ft DEVICE (ONY FILENflPC, fV^Y EXTENS.Oh 

ill? ASTERISKS ARE TYPED FOR BOTH THE FILENAME ANC T^C EXTEnSION- 

Hp riT3:«.« ICAHS ALL FILES ON MAGTAPE 3 

IIX 

{{32 4.22 THE "HILD CHARACTER" CONSTRUCTION 

1133 

1 IM 

1135 T« -UILD CHARACTER- CONSTRUCTIOH PERMITS REFERENCE TO ALL FILES 

llS HhOSE FILE NAMES DIFFER IN SPECIFIC CHARACTER POSITIONS. UHEN 

1137 SEARCHING FOR FILES CORRESPONDING TO THE NAME IN THE COfllAND STRING, 

1138 ANY CHARACTER IS ACCEPTED AS MATCHING A QUESTION HARK. FOR EXAMPLE: 

1140 DKO:UPD».DOC MEANS ANY FILE HHOSE NAME BEGINS WITH "UPO", 
UMl HAS ANY CHARACTER NEXT (INCLUDING A BLANK) 

1142 AND THEN THO BLANKS, UITH A .DOC EXTENSION. 

1143 UPOl.DOC AND UP02TR.OOC MOULD BOTH QUALIFY. 
1144 

1145 
1 146 

1147 4.23 THE FILE COMMAND (UPD2TR) 

1146 

1149 

HSO THE FILE COMMAND IS USED TO 00 BULK TRANSFERS FROM ONE DEVICE T0_ 

1151 ANOTHER. IT IS SIMILAR TO A PIP COMMAND EXCEPT THAT IT CAN UTILIZE 

1152 THE -ASTERISK- AND -MILD CHRRACTER" CONSTRUCTIONS. IF A FILE OF THE 

1153 SAME NftC ALREADY EXISTS ON THE OUTPUT DEVICE. THE FILE COMMAND ^ 

1154 (UNLIKE THE PIP COMMAND) Wia DELETE THE OLD TILE. NOTE ALSO THAT 

1155 THE FILE COMMAND CAN TRANSFER BOTH LINKED AND CONTIGUOUS (CORE- 

1156 IMAGE) FILES. 

{}§ FILE DEV:<DEV:FILNAM. EXT ; COMMAND FORMAT 

lllo kWERE THE DEVICE NAME ON THE LEFT IS THE OUTPUT DEVICE AND 

1161 THAT ON THE RIGHT IS THE INPUT DEVICE. 

1162 

1163 

1164 4.24 THE FILEF COMMAND (UPD2TR) 

1165 

1166 

1167 THE FILEF COMMAND IS USED TO DO FAST TRANSFERS ONTO ALL DIRECTORY DEVICES. 

1168 FOR Mfe^TAPELOGICAL END OF TAPE IS FOUND AND ALL THE REQUESTED 
116? FILESARE TRANSFERRED SEOUENTI«.LY ONTO T« TAPE STARTING AT THAT 

1170 POINT. THIS FAST TRANSFER COMMAND ELIMINATES THE CHECK OF^THE TAPE ^ 

1171 DIRECTORY UHICH IS HADE BEFORE EACH FILE TRANSFER IF THE FILE COMMAND 

1172 IS USED. 
1173 

117M FOR RANDOM ACCESS DEVICES THE FILE IS TRANSFEREO TO THE FIRST 

1175 AVAILABLE SPACE ON THE DEVICE. 

1176 

1177 

1178 FILEF DEV:<DEV:FILNAn.EXT ; COMMAND FORMAT 

1179 

UBQ 
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1181 H.25 THE FILED COtlflftrC (UPD2TR) 

llP THE FILED COMMftND DELETES THE FILES NftMED FROM THE DEVICE'S DIRECTORY. 

11» FILED DEV:FILN«M.EXT jCOMTimO F0R1RT 

1187 

1188 UP02TR NOW PERfllTS THE USE OF THE DEL(ETEJ COMMAND WITH » AND UILD CHflRftCTER 

1189 FILENflTE CONSTRUCTION. EXAMPLE: 

111? DEL DKO:«.BIN ;DELETES fiLL FILES IN DKO- WITH .BIN 

1192 IexTENSION- 

il9M CAUTION!'.; THE IM)2TR PROGRAM DOES NOT REQUIRE VERIFICATION OF A PASS 

1195 DELETION COMMAND. THE USER MUST BE CAREFUL NOT TO 

11% SPECIFY A DELETE THAT HE DOES NOT REALLY MEAN TO OCCUR. 

1197 IF IT SHOU.D. TYPING CONTROL C UILL ABORT T»C COMMANC 

1198 AT THE EARLIEST OPPORTUNITY. 
1199 

1200 4.2b THE FILEL COMMAND (UP02TR) 

1201 

1202 

1203 THE FILa COMMAND SEQUENTIALLY LOADS INTO CORE EACH FILE REFERENCED. 

120H IT ASSUMES THAT ALL REFERENCED FILES ARE ABS FORMAT (IF NOT A CKSMER 

1205 OR EOH_SRQR MILL OCajR)._lTS PURPOSE IS TO SHOW THAT ALL ABS 

jfob FORMATTS^PILES CAHBE CORRECTLY LOADED (CHECKS FOR DEVICE AND 

1207 CHECKSUM ERRORS). IF AN ERROR XCURS, IT UILL IDENTIFY THE TYPE OF 

1208 ERROR fHi THE DEVICE. 
1209 

1210 FILEL OEVrFILNAM.EXT :COMMAND FORMAT 

1211 THE LOAD COMMAND HAY ALSO BE USED IN UPDSTR TO PERFORM THE SAME FUNCTIONS 

1212 AS THE FILEL COMMAtC. 
1213 

1215 H.27 THE FILEG COMMAND (UPD2TR) 

l|lb 

lIlB THE FILEG (FILE GET) COMMAND IS SIMILAR TO THE FILEL COMMAND EXCEPT 

1219 THAT IT LORDS AND CHECKS CONTIGUOUS (CORE-IMAGE) FILES INSTEAD OF 

1220 ABS FORMT FILES. DEVICE ERRORS AND SIZE ERRORS UILL BE REPORTED. 

liil FILEG DEViFILNAM.EXT ; COMMAND FORMAT 

1223 

122H THE GET COMMAND HAY ALSO BE USED IN UP02TR TO PERFORM THE SAME FUNCTIONS 

122S AS THE FILEG COMMAND. 

122b 

1227 4. 28 THE FILET COMMAND (UPD2TR) 

1226 

1229 

1230 

1231 THE FILET COHHAND TESTS ALL FILES NAHED BY READING THEN INTO A BUFFER 

1232 TO HAKE CERTAIN THAT NO DEVICE ERRORS OCCUR. ANY DEVICE ERRORS ARE 
J 233 LISTED AS THEY OCCUR. 

1234 

1235 FILET DEV:FILNAH.EXT ; COHHAND FORHAT 

123b 
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1237 

1240 
1241 
1242 
1243 
1244 
1245 
12% 
1247 
1246 
1249 
1250 

1253 
12SM 
1255 
1256 
1257 
12SB 
125S 
12&0 
1261 
1262 

1265 
1266 
1267 
1266 
126S 
1270 
1271 
1272 
1273 
1274 
1275 
1276 
1277 
1278 
1279 
1280 
1281 
1282 
1263 
1284 
1285 
1286 
1287 
1288 
128<3 
1290 
1291 
1292 
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4.29 THE /LP fWD /N SWITCHES (UPD2TR) 

THE "FILE" COffWCS NOWIftLLY CAUSE PRINTING Of THE NAMES Of T« FILES 

Wt« T^.'^w^^mEf^^sm^'^h, TO ec 

OUTPUT ON TH| LINE PRINTER INSTEAD. THE /N SWITCH INHIBITS PRINTING 

OF THIS irrORMATION, SO THAT ONLY ERROR PRINTOUTS ARE OUTPUT. SWITCHES NUST 

NOW BE SPECIFIED AT END OF THE COftlAND STRING. 



4.30 



4.31 



FILET DKO:».»/LP 



FILEL /N HT2:«.BIN/LP 



DEL OKO:t. TXT/LP 



:TEST ALL FILES ON OKQ AND PRINT 
THE FILE irrORMATION AND ERROR 
•INFORMATION ON THE LINE PRINTER 

;LOAD ALL .BIN FILES FROM NAGTAPE 2, 
; REPORTING ONLY ERROP INFORMATION 
•ON THE LINE PRINTER 

; DELETE ALL .TXT FILES FROM DKO: AMD 
•PRINT DELETED FILES ON LINE PRINTER. 



THE "EOT- COMMAND 



(UPD2TR) 



THE -EOT- COMMAND IS PROVIDED AS A MEANS OF PLACING AN "END-OF-TAPE" 

mm OR SENTIfCL FILE AT A SaECTED SPOT ON MAGTAPE OR CASSETTE. APPLlCATIOh 

OF THIS COftWC INaUDE REPLACING AN "EOT- MARK WHEN IT HAS BEEN 

ACCIDCNTALLY DESTROYED, OR WHEN THE USER WIS«S TO DELETE FILES AT THE 

Ere OF THEMEOIUH. AND STILL BE ABLE TO USE THE SPACE TAKEN UP BY 

THOSE DELETED FILlS. 

THE PROCEDURE TO BE USED IS AS FXLOWS: 

A, POSITION THE MAGTAPE BY PERFORMING A FILET COMMAND ON THE FILE 
PRECEDING THE SPOT WHERE THE "EOT" IS TO BE PLACED. IN PRACTICE. 
IF AM -EOT- HAS BEEN LOST, THE USER SHOULD FILET THE NEXT TO TH^ 
LAST FILE, SINCE THE LAST FILE HAY BE UNRECOVERABLE. 

8. PERFORM AN "EOT" COMMAND. 



EXAMPLE: 



«FILET HT0:ZQRAO0.BIN<CR> 
»EOT<CR> 



; READS FILE 2QRAO0.BIN AND STOPS. 
I WRITES EOT. 



THE TEXT COMMAND 



IUP02TR) 



UPD2TR INCLUDES THE FACILITY TO EXECUTE A SEQUENCE OF COMMANDS 
CONTAINED IN AN ASCII TEXT FILE. THIS ASCII TEXT FILE IS CREATED 
VIA THE TEXT COMMAND. ALSO SEE SECTION 4. XTECO TEXT EDITOR. 

TEXT DEVrFILNAM.EXT ; COMMAND FORMAT 

WHEN THE TEXT COMMAND IS ISSUED UPD2TR OPENS THE NAMED FILE FOR 
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iPS3 OUTPUT AND RESPONDS WITH fi OUOTPTION MftRK (") TO itCICflTE ITS 

1294 REfiOirCSS TO ACCEPT TEXT. AMY ASCII CHARACTER (EXCEPT CONTROL C AfiO 

12% RUBOUT) UILL BE ACCEPTED AS INPUT TO THE TEXT FILE. CONTROL C (tC; 

i|% UILL ABORT TEXT MODE. RETURNING TO C0W1AND MODE A(« CLOSING 

l|s7 THE OUTPUT FILE. CONtRa 2 (tZ) IS THE STANDARD TERfllNfiTOft FOR INPUT 

1298 TO THE TEXT FILE. RUBOUT CAN BE USED Jc DELETE CHARACTERS ON THE 

1299 CURRENT LINE (BUT NOT ON PRECEDING LINES). 

iSl THREE CHARACTERS. THE POUND SIGN (•), THE SEMICOLON (;). AND THE DOLlAR _ 

1^ SIGN (S) ^ HAVE Special significance in the text file, the • sign and ; are 

1303 USED to StART A CONHENT WHICH IS TO BE PRINTED DURING COIflAND FILE 

130M EXECUTION. THE S SIGN 15 USED TO START A COMMENT WHICH IS TO BE PRINTED 

1^ AND FOLLOWED BY A HALT DURING COMMAND FILE EXECUTION (SUCH AS "IPRESS CONT 

1306 WHEN ^AOr). 

1307 

1306 

130S 4.32 THE PRINT COMMAND (UPD2TR) 

1310 

1312 THE PRINT COMMAND OUTPUTS A FILE ON THE LINE PRINTER. IT,IS_ 

1313 USED TO PRINT TEXT FILES. AND WILL OUTPUT TO THE LifC PRINTER. 

1314 AFTER THE TEXT FILE IS PftlNTED THE PROGRAM OUTPUTS 10 CARRIAGE RETURNS 

1315 AND LINE FEEDS TO SIMULATE A FORM FEED. NOTE THAT BOTH PRINT AND TYPE 
131b COMMANDS A^PT « AND WILD CHRRfiCTEA CONSTRUCTION INFILENAMES, SO 
1317 THATMULTIPLE TEXT FILES MAY BE PRINTED WITH ONE COMMAMD. 

131B 

1319 PRINT DEV:FILNAM.EXT ; COMMAMD FORMAT 

1320 

1321 PRINT DEV:«.TXT 
1322 

1323 WHERE DEV IS THE SOURCE DEVICE ON WHICH THE FILE RESIDES. 
1324 

132S NOTE THAT NO CHECK IS MADE OF FILE PRINTABILITY. 

1326 

1327 

1328 4.33 THE TYPE COMMAND (UPD2TR) 

1329 

1330 

1^ SAME AS THE PRINT COMMAND EXCEPT THAT IT OUTPUTS TO THE CONSOLE 

1332 TERMINAL INSTEAD OF TO THE LINE PRINTER. 

{3^ TYPE DEV:FILNflM.EXT jCOHMAND FORMAT 

1335 

133b 4.34 THE 00 COMMAND (UPD2TR) 

1337 

li IS P?J°S8f Bi^olfSe WtSS MW< W/J^t*£, 

13h3 via M text COMMAND^ OR VIA THE XTECO TEXT EDITOR PROGRAM (SEE SECTION 4. ) 
13% 

1347 DO DEVjFILNAM.EXT ; COIflAND FORMAT 

1346 



HD3 
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1349 

1350 H.35 THE RSG (ASSIGN) COnfVWC (UP02TR) 

1351 

THE ASG (ASSIGN) COrmO ALLOWS THE USE OF LOGICAL DEVICE NAMES IN 

IXM COHNAND FILES. AUC)MED LOGICAL DEVICE^NAMES ARE 1.2»3x5a SYS. 

1K5 A COHMAND FILE flAY USE A LOGICAL NAME SUCH AS X Jm^tW OF 

1356 SPECIFYING. FOR EXAHPLE^O OR OKI. T>CN, JEFQRE EXECUTING 

1X7 THE COfflANft FILE. THE uSoTcAN ASSIGN THE'DESI»0 PHYSICAL DEVICE 

1358 TO THE LOGICAL nAmE, PEPWTTING USE OF ANY AVAILAflLE UNIT. 

1359 ASG PHYSICAL DEV = COGICAL DEV {COHNAND FORMAT 
I3b0 

i3b2 REVERSAL OF PHYSICAL AND LOGICAL DEVICE NAMES IN THE COMMAND STRING 

I3b3 RESULTS IN "INVDEV ERROR MESSAGE. THE COMMAND IS NOT PERFORMED. 
l3bH 

1^1 ASG OKI: = 2: ; ASSIGNS DISK 1 TO LOGICAL DEVICE "2" 

1367 

1366 

1369 

1370 

1371 4.37 THE PATCH COMMAND (UPD2TR) 

1372 

1373 

137M THE PATCH COMMAND ENABLES THE USER TO PATCH A PROGRAM ON ANY DIRECTORY- 

1375 ORIENTED (RANDOM ACCESS) TROP SUPPORTED DEVICE. NO^OUTPUT 

1376 DEV: FILE SPECIFICATION IS REQUIRED OR PERMITTED, THE I*UT DEVICE 

1377 IS ASSUMED TO BE T« DESIRED OUTPUT DEVICE. 

1379 THE FILE(S) TO BE PATCHED MUST BE IN ABS FORMAT 

1380 BINARY FILE. THE PATCH TOjJTINE DOES NOT C«CK IN ADVANCE 

1381 FOR CORRECT Fill FORMAT. THE FOLLOWING EXTENSION 

1382 ARE FOR TRDP ABS FORMAT FILES; .BIN, .BIC, .NPG. 
1383 

1385 CARRIAGE-RETURN OR LINE-FEED ARE THE ONLY CHARACTERS MHICH HAY BE USED 

1386 FOR TERMINATING A TYPED ENTRY. T« LINE-FEED MAY BE THOUGHT OF AS AN 
1M7 -AOVANCr KEY^ICH HILL GO TO TJC NEXT ADDRESS. THE RUBOUT KEY HAY 

iSe BE l^TO COARECT TYPING MISTAKES MADE ON INPUT. ALL ADDRESSES ENTEgD MUST 

1389 p^OMpf^' ^ '^^^CIRESS IS TYPED (IN RESPONSE TO A PROMPT) UHICH IS 000, THE 



1390 PROMPT HILL BE RE 

1391 

1392 IF AH ADDRESS IS TYPED HHICH IS NOT HITHIN THE CORE LOAD LIMITS OF THE FILE 

1393 BEING OPlmTEQ UPON^ THE UNKNQHN CONTENTS OF T« SPECIFIED ADDRESS HILL 

1394 K INDI«TO) BY 'XidOOOr. TICPROGRAM Hia THEN GIVE THE USUAL 

1395 PROMPT, ASKING IF MODIFICATION IS DESIRED. 

1397 IN RESPONSE TO THE "AOOR?" PROMPT. IF A CARRIAGE-RETURN OR A 

^WuliJW^Jf'"^^'^^^' ^ S8f^^^2lteJViSJ{TE-E^E 

1400 THEOUTPUT DEVICE AND CO^IRM T« FACT' THAT THE PATCHES SHOULD BE ENTERED 

1401 INTO THE SPECIFIED FILE. 
1402 

1403 IF A FILE IS MODIFIED BY T« USE OF T»€ "PATCH" COMMAND, THE DATE AND 

14S LENGTH OF THE FILE OPERATED UPON ARE UPDATED IN THE DEVlCE DIRECTORY AS 
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1405 REQUIRED. 
IHOb 

1407 IF THE FILE BEK'G PftTCHED COf^TAINS REPR£SEN"'flTIOWS OF ISOLATED SINGLE-BYTE 

1406 DATA, FOR EXAWLE THOSE GENERATED BY THE FOLLOWING ASSEMBLY 
140S CODE SEQUENCES: 
,410 

Mil A. .=?H 

Ml* .BYTE 120 

413 .EVEN ; GENERATES ONLY 1 BYTE OF DATA 

414 

415 B. .=413 

mf> BYTE"! 

417 CORE LIMITS. OCCURS DURING DUMP COMMAND. 

41! DIRERR INVALID NRHE IN DEVICE DIRECTORY. 

h|i DELERR BIT MAP ERROR DURING DELETE OPERATION ON DECTAPE OR DISK. 

NOT USUAL UNLESS MEDIUM HPS SEEN WIPED OUT? TRANSFER 
423 FILES TO OTHER MEDIUM. (SEE SECTIOh 4.). 

sis POFLOU PROGRAM TOO LARGE TO LORD UITHIN EXISTING CORE SPACE. 

IHp INVSW INVALID SWITCH SPECIFIED IN COMMAND STRING. 

IW* ERROR ^il^M'MMl'VLM^W&^mi »,TCH 

1431 DATA IN CORE. 
1432 
1433 
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1M3S 




1H35 


S. ERRORS 


1M36 




4437 
1H3B 


INVCHD 






1H»H3 


INVO£V 




• lit 1 


INVROR 


1443 


1444 




1445 




14% 




1447 




1448 




144S 




1450 


NEXFIL 


1451 


1452 


OELOLO 


1453 



J03 



INVRLID COffllRND. CHECK COWWND JUST GIVEN. 

INVALID DEVICE SPECIFIED FOR COmPNO GIVEN. 

INVRLID RD0RES5. MUST BE EVEN. UITHIN EXISTING LOCORE 
RND HICORE LIMITS, AND MUST n6t BE UITHIN UPDATE PROOSAM. 

INVALID FILE NAME. NO SPECIAL CHARACTERS ALLOICD. 
A THROUGH 2. AND 0 THROUGH 9 ARE ONLY VALID CHARACTERS. 
^JQCURS IF i OR WILD CHARACTER CONSTRUCTION FILENANES 
ART SPECIFIED TO A COMWAWO THAT DOCS NOT AUOH IT. 

NON-EXISTENT FILE. FILE DOES NOT EXIST IN DEVICE DIRECTORY. 

DELETE OLD FILE BEFORE GIVING COHHAND THAT UOULD CREATE 
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I45M 

mSS S.l ERRORS UNIQUE TO THE FILCMP COmflND 

iS UNEOUfiL FILE TYPES INOICfiTES THE TWO FILES BEING COHPAREC 

14p ARE NOT OF SlfllLAR STRUCTURE. 



1H60 



UfCOUftL FILE SIZES INQICeiE^^HI^TUO^FitFS BEING COnW«ED 



PRE NOT THE SMC SIZE 
I»igM SCRPTCH FILE SHORTER THPN HPSTER FILE 



THE 



1%^ BPCK PRROU IN THE COtmO STRING. 

[1^ '"^^ ™* fi^SCROTCH FILE ».ICH IS m T* 

1471 LEFT OF THE BPCK PRROW IS LONGER 

1472 THPN TtC FILE OH THE RIGHT. 
1473 

«g '^'^ ^ffiin^ICATES T«« «S * I« 

SScSm ^^fc'l^gi'JclE THE 

1478 ERROR OCCURRED. 
147S 
1480 
1481 



I 
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1HB2 

14^ UPDATING TROP flEOIP 

148M 

UPOflTINC TROP fCOIft CONSISTS OF: 

IHW fi. PATCHING EXISTING PR0CRW1S tDEPO). W _ 

148? B, REPLACING PROGRfiNS UITH NEWER VERSIONS, OR 

1490 C. ADDING NEb PROGRAHS. 
1491 

1452 WHEN FIRST BECOMING ACQUAINTED HITH THE USE OF THE UPDATE PROGRAMS 

l4S ThI user SHOULD HAKE EXTRA SURE THAT A BACKUP FOR THE MEDIUM TO 

1494 8E MOOIFiraEXISTS. IN ORDER TO BE ABLE TO RECOVER FROM FATAL ERRORS. 

14« (ZEROING THE MEDIuA, DELETING THE WRONG FILE, ETC.). 

1497 b.l PATCHING EXISTING PROGRAMS 

1498 

1500 PATCHING A PROGRAM IN A TROP MEDIUM CONSISTS OF: 

1501 A. LOADING EXISTINQ PROGRAM INTO MEMORY (LOAD COMMAND) 

1504 D. STORING MODIFIED PROGRAM (DUMP COMMAND). 

lis AN ALTERNATE. SAFER, PROCEDURE MOULD STORE THE PATCHED PROGRAM FIRST, 

1507 Arc TfInAfHr TRYlte 1^ MODIFIED PROGRAM, THE OLD PROGRAM MOULD 

1508 BE DELETED. 
1509 

1510 EXAMPLE: 
1511 

1513 «LOAD MTO: D0SA0.BIN ^l-OAO^PROGRAfl) 

1514 «MOD 3H50 (MODIFY PROGRAf) 

1515 003450 012737 000000 

151b »M0O 37bb 

1517 0 037bb 012737 000000 

ISIB 003770 QQ0005 000000 

1519 fOEL MTO-OOSW.BIN (DELETE OLD PROGRAM) 

1520 iOUMP HTOTO^l.BIN (STORE MODIFIED PRO-»AM) 

1521 ftLOAO MT0:0^1.ilN (LOAD NEU PROGRAM) 

1522 Start 200 (try out neu program) 

1523 

1524 IT IS important UHEN IMPLEMENTING DEPO'S THAT THE NAME OF THE 

1525 PRoSaM «FUCT THE OEPO LEVEL OF THE PROGRAM. SEE APPENDIX D. 
152b PROGRAM NAMING CONVENTIONS. 

1527 
1528 
1529 

1530 b.2 REPLACING PROGRAMS MITH NEWER VERSIONS, OR 

1531 

1532 ADDING NEW PROGRAMS 

1533 

1534 

1535 TO REPLACE A PROGRAM, OR TO ADD A NEW ONE: 
153b 

1537 A. DELETE OLD PROGRAM IF REPLACING IT, 
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i538 B. LOAD f€H PROGRAM INTO MEMORY. 

153q C. DUMP PROGRAM ONTO DEVICE. 

1^ EXAMPLE 1: 

\^ »OEL MTO: OOSA1.BIN (DELETE OLD PROGRAM) 

ftLOAO PR: (LOAD fCU PROGRAM ) 

15H5 iOUMF MTOrDQSBO.BIN ! STORE JCHPRO^) 



iSMfi 

ISHS EXAMPLE 2- 
1550 

1^ DEL MTO: 00SA1.BIN 



OaETES OLD PROGRAM. 
LOADS NEW PROGRAM FROM PAPER TAPE. 



LOADS CORRECTLY. 

FROM CASSETTE OR MAC 



1552 LOAD PR: 

1S3 DUMP MTQ:D(mi.BIN 

ISH LOAD MTOiH^.BlN 

i§ f«.TE:_0|UTINGJ_PRgGRAH_F50^ 95.?**CTAPE^DpESJJOT^PHYSICALLY 

CLEAN UP THE CASSETTE OR MHGTHPt. II nubi Ht twitu viH 

isl MONITOR'S COPY ROUTINE, WHICH COPIES ONLY "GOOD- FILES. 
1560 

iSJ »PIP MT0!0VLY.BIN«-PR: (PIP TO MTO: FROM PR: ) 

lol »LOAO MT0:0VLY.BIN (LOAD OVERLAY) 

lis RELOaiNC OF A PROGRAM THAT HAS BEEN "PIPPS1.0IRECTLY TO fi^DEVICE 

iS? IS IMPORTANT. TO mX. THAT NO KADING ERRORS HAVE OCCURRED. 

1567 THE PIP COMMAND DOES NOT CHECKSUM INPUT DATA. 

1%S &.3 GEfCRATING A TROP MEDIUM 



11 . 

li72 IT MAY BE DESIRABLE TO CREATE A CUSTOM MADE MEDIUM CONTAINING ONLY 

llTb A. PROCESSOR TESTS 

C: I^OPROGRAmI FOR THAT SYSTEM 

157^ 

1580 WITH SUCH A MEDIUM. THE ENTIRE SYSTEM COULD BE TESTED USING THE 

1581 CHAIN M& OF OPERATION, WITHOUT HAVING TO SWITCH DECTAPES, OR CfiSSEHES. 
1562 

lIB THE PROCEDURES FOR GENERATING A NEW MEDIUM FOLLO.J. 
158M 

iSas 

158b b.3.1 CREATING A NEW TROP MAGTAPE 

1587 

1588 

158*3 A. MOUNT "NEW" MAGTAPE ON DRIVE 0 

1590 B. PERFORM THE FOLLOWING COMMANDS: 

Hie FOR A TR7<3F 

15S3 
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1594 
15% 
15% 
1597 

IbOO 
IbOl 
1&Q2 
lb03 
IbCX 
IbOS 
IbOb 
lb07 
IbOB 
IbOS 
IblO 
1611 
1&12 
1613 
IblH 
1615 
1616 
1617 
1618 
1619 
1620 
1621 
1622 
1623 
162S 
1625 
1626 
1627 
1628 
1629 
1630 
1631 

W 

If 

u 

1637 
1638 
1639 
1640 
1641 
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ZERO: UTO: 
lOftO DKO:TRDP.BIN 
SAVE f1T0:TRDP.SflV 
DUMP nTO:TRDP.BlN 
LOAD DKO: UPOTR.BIN 
DUMP tITO: UPOTR.BIN 



6.3. 9 CREATING A TROP MEDIUM - COMMON PROCEDURE 



ONCE THE MONITOR HAS BEEN SAVED ON THE MEDIUM, JPD2TR.BIN 
SHOULD BE SAVED: 



FILEF DEVI :<DEVO:UPD'. BIN 



; TRANSFERS UPD1.BIN AMD UP02TR.BIh 



CONTIGUOUS (CORE-IMAGE) FILES SHOULD BE TRANSFERRED NEXT (TO GUARANTEE 
ROOM ON THE MEDIUM). THIS CAN BE DOME VIA THE FILEF COMMJM): 



FILEF DeVl:<DCyO:A.SAV 



;TRANSFER A.SAV 



FROM THIS POINT ON, THE DESIRED PROGRAMS ARE TRANSFERRED FROM TfC 
INPUT MEDIA TO THE OUTPUT [CDIUM VIA THE FILEF CqBgC. USEOF THE 
SPECIAL FEATURES CAN CONSIOCRAeLY DECREASE T« NUNBER OF COMMANDS 
REQUIRED. FOR EXAMPLE. TO TRANSFER ALL DECTAPE DIAGNOSTICS TO THE 
NEU MEDIUM A SirttLE FtLEF COMMAND UILL SUFFICE: 



FILEF DEVl:<DEVO:XTC»".t 



TRANSFERS ALL PROGRAMS UHOSE 
•NAMES START HITH "XTC" 



AFTER ALL THE DESIRED FILES HAVE BEEN STORED ON THE NEW MEDIUM, 
IT SHOULD BE TESTED VIA THE FILET, FILEL, AND FILEG COMMANDS: 



FILET DEV1:».»/LP 
FILEL DEVl:t.BIVN 
FILEG DEVl:i.SAVN 



READ EVERY FILE ON T« NEU MEDIUM. 
LISTING AU INFORMATION ON THE 
LINE PRINTER 

LOAD ALL AOS FORMAT FILES 
TO VERIFY THAT NO ERRORS 
OCCUR. LIST ERRORS ONLY. 

OCCUR. 

LIST ERRORS ONLY. 



IT IS ALSO A GOOD IDEA TO DUPLICATE THE NEU MEDIUM TO PROVIDE A 
BACKUP. 



BOH 
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1SH3 

lb% 

1647 
lb4S 
lbH9 
IbSO 

ibl! 

1&5M 
IbSS 
IbSb 
1657 
1658 
1659 
1660 
1661 
1662 
1663 
1664 
1665 
1666 
1667 
1668 
1669 
1670 
1671 
1672 
1673 
167M 
1675 
1676 
1677 
1676 
jb79 

1683 
168H 
1605 
1666 
1687 
1686 
lbd9 
1690 
1691 
1692 
1693 
1694 
1695 
16% 
1697 



fiPPEMDiX 8. UP02"™ P90GRflf1 COflflrCS 



FILL<CR> 

CLR<CR> 
XFR<CR> 

DUnP 0EV:FILNM1.EXT 
L(MO 0EV:DILNM1.EXT 
PIP DEV1:FILN«1.EXT«-DEV2 
SAVE DCV.-FILfMH.EXT 
GET DEV:FlLN«f1.EXT 
tlOO ADR 
CORE 

LOCORE ADR 

HICORE AOR 

DIR DEV: 

DIRLP DEV: 

DEL DEVrFILNAM.EXT 

ZERO DEV: 

BOOT DCV: 
SAVM DEV: 

START 

START AOR 

ACT 

NOTACT 

FILE OEV:<DEV:FILENAH.EXT 
FILEF OeV:<OEV:FILNAri.EXT 



SETS UP TEHniHAL FOR CORRECT PRINT 
AFTER CRLF. 

CLEARS CORE BELOU UPDATE PROGRAH 

PERniTS nAKiNC PROGRAM SELF -START INC. 
OR NON SCLF-StARTING. 

WRITES rCnORY CONTENTS IN ABS FORMAT 

LOADS ABS FORMAT PROGRAM (.BIN, .BIC) 

FILNAN.EXT COPIES FILE FROM ONE DEVICE TO ANOTHER. 

URITES MEMORY CONTENTS ONTO CONTIGUOUS BLOCKS 

LOADS CORE IMAGE PROGRAM 

MODIFIES CORE CONTENTS 

TYPES PROTECTION LIMITS 

ENTERS LOW PROTECTION LIMIT 

ENTERS HIGH PROTECTION LIMIT 

TYPES DEV DIRECTORY ON TTY 

TYPES DEV DIRECTORY ON LINE PRINTER. 

DELETES FILE FROM DEV DIRECTORY 

ZEROES DEVICE DIRECTORY 



BLXK Q OF 
S 4K ONTO DEV 



DEV STARTING AT LOC 0OOC30 
STARTING AT BLOCK 30 



STARTS PROGRAM AT LOC OOGQOO 
STARTS PROGRAM AT ADR 
PUTS UPD2TR PROGRAM IN "ACT MODE- 
TAKES UPD2TR PROGRAM OUT OF "ACT MODE* 



COPIES FILE(3) FROM ONE DEVICE TO 
ANOTHER. DELETING FILE OF SAME NAfC 
BEFORE 60ING THE TRANSFER 

SAME AS FILE EXCEPT THAT WITH CASSETTE OR 
mCTAPE FAST TRANSFERS ARE PERFORMED (NO OIR CHE 



C04 

.miH. flftCYll 27(732) Ol-mm-T? 10:3S WWE HO 

onQXAe.nu 



1700 
1701 

170M 
1705 
170b 
1707 
17QB 
i7OT 
1710 
1711 
1712 
1713 
1714 
1715 
171b 
1717 
1718 
171<3 
1720 
1721 
1722 
1723 
r24 
1725 
172b 
1727 
1728 
172S 
1730 
1731 
1732 
1733 
1734 
1735 


FILH DEVrFILNPII.EXT 


READS FILE AND CtCCKS FOR DEVICE 
CTRORS (FILE "TESr*) 


FILEL OeV:FlLri«n.EXT 


LOADS FILES (^Un|5 ABS FORMAT) 
CHECKING FOR OEVICi ATflTCtCCKSUn ERRORS 


FILEG OeV.-FILNfM.EXT 


LOADS FILES (ASSUHES CONTIGUOUS FORHATl 
CHECKING FOR DEVI(^ AtC FILE SIZE ERRORS 


FILED DEV:FILNfiM.EXT 


DELETES NAKED FILES 


FILCHP 0EV:<0EV:FILN»1.EXT 


COtff>ARES TUO FILES AGAINST 
EACH OTHER ON TUO TRDP HEOIUrS. 


PATCH 

TEXT 0EV:FILt1flM.EXT 


ENABLE THE USER TO PATCH A 
PROGRAM. 

CREATES TEXT FILE FOR PRINTING 
OR FOR COmAND EXECUTION 


PRINT DCV:FILNRn.EXT 


OUTPUTS A FILE TO THE LINE PRINTER 
(ASSUMES IT ENDS WITH A tZ) 


TYPE 0EV:FILNW1.EXT 


OUTPUTS A FILE TO THE CONSOLE TERMIiiAL 


00 OeVrFILfWM.EXT 


EXECUTES A COMMATC FILE. 


ASG PHYSICAL - LOGICAL 


ASSIGNS A PHYSICAL DEVICE TO A 
LOGICAL DEVICE NAME 


PAT 

EOT 


LBTTCC etf\ nc TODC Moot/ fCIl O ON notiJUK 

OR CASSETTE AFTER TAPE HAS BEEN POSITIONED. 


PATCH DEVrFILNAH.EXT 


ENABLES PATCHING CAPABILITIES 
TO A FILE ON THE TRDP MEDIA. 


FILCHP 0EV:sOEV:FILNAf1.EXT 


COMPARES TUO FILES UITH 
EACH OTHER. 


1739 
1740 
1741 
1742 
1743 
1744 

17% 
1747 
I74e 
1749 
17S0 


tC (CONTROL C) 
tZ (CONTROL Z) 


RETURNS TO COHMAND flOOE (OPEN OUTPUT FILE 
IS CLOSED). 

ENDS INPUT TO A TEXT FILE 


« 


USED FOR FILE NAMING TO MEAN "ANY* 
(ANY FILE NAME OR ANY FILE EXTENSION) 




USED FOR FILE NAMING TO INDICATE A UILD 
CHARACTER (ANY CHARACTER UILL NATCH IT) 


• OR ; 


USED IN A FILE OF EXECUTABLE COMMANDS 
TO START A COMTCNT LINE UHICH IS TO 
BE TYPED DURING EXECUTION 




S 


SAME AS • BUT CAUSES A HALT AFTER 
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175M 
17S5 
1758 



Ol-WW-77 10:3<3 PAGE 41 



DC4 



THE COftlENT IS PRINTED 



EOS 
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1757 
1758 
175^ 
1760 
l7Si 
171.2 
I7b3 
17%M 
I7t,5 
iTSfe 
17h7 
I7fa8 
1769 
1770 
1771 
1772 
1773 
177M 
1775 
177b 
1777 



ftPPENDIX C. PERIPHETflLS SUPPORTED BY UPDATE FROGRAMS 



TRDP SUPPORTS OR WILL SUPPORT THE FOLLOUINC OEVICC?: 



PR 
PP 
KB 
PT 

OKN 
HTN 

CTN 



PCU HIGH SPEED PAPER TAPE READER (UPD2TR) 

PCll HIGH SPEED PAPER TAPE PUNCH (UPD2TR) 

TTY KEYBOARD, OR LOW SPEED READER (UPD2TR) 
TTY PRINTER AND PUNCH (UPD2TR) 

RK11/RK05 DISK (UPD2TR, N=0-3) 

TR79F riAGTAPE 9 TRACK (UPD2TR, N=0) 

TAU CASSETTE (UPD2TR, N=D OR 1 ) . 
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APPENDIX D. PROGRAM NAWMC CONVENTIONS 



786 

7l3 

P4 

793 
7«W 

73B 
79S 

§8l 
802 

IS 

805 

§8^ 

806 
809 
810 
811 



T« FOLLOHING PROGRAM NAMING CONVENTION HAS BEEN JSED FOR TRDP 
ITS UX HILL PERMIT USERS_ T0_PETERMINE_B0IH THE VERSION. AND THE 

PROgI^'"A« ll)pSA?E?fN 



i. 



PROGRAMS. CONTINUED OF THIS SCHEnt WHEN 
THE FIELD IS HIGHLY RECOMMENDED. 



ZFPKAI 
tttttt 

^1 iil- 



I 

II 
II 
II 
II 
II 
I- 



II 
II- 
I-- 



— • 

0 
-A 
-A 

Q 
--2 
-A 

B 

C 

z 



INDICATES HCN LEVEL 




THRU 9 2 OVERLAY DESIGNATION 
DIGITS = QPTIOW DESIGNATION 
r 11/05,15.20 PROCESSORS 
= 11/25 PR6cESS0R 
r 11/45 PROCESSOR 
= ALL PROCESSORS 



D INDICATES A DIAGNOSTIC PROGRAM, AND IS NOT USED 

IN NAMING A PROGRAM. 

.BIN EXTENSION USED TO STORE PROGRAM IN AeS FORMAT. 



G04 



.nfllM. HflCYH 27(732) Ol-fWR-77 10:3S PftGE 44 

onoxM.mi 



lil3 7. HELP ftSCII REDRENCE FILE 

1814 

leis 

18l| 

1820 THE FILE Cm BE TYPED/PRINTED OUT BY USING STAfCftRD 

1821 UPDATE commos. 

{if! DETAILED CftI'D DISCRIPTIOH REFRENCE TROP USER HRNUAL M-U-DMOXfl 
1824 

I82S TRDP RESIDENT MONITOR CONfWNOS 

lii^ F<CR> iET'cONSOLE FILL COUNT 

iB2fl D<CR> DIRECTORY ON THE TTY CONSOLE ^ ^ 

laP D/F<CR> SHORT DIRECTORY ON THE TTY CONSOLE 

1830 0/L<CR> DIRECTORY ON THE LINE PRINTER , 

1835 S ftODR<CR> STARTS PROGRRH RT SPECIFIED ADDRESS 

1838 
183S 

1840 XXDP RESIDENT MONITOR ERROW 

1BH2 INVCnD/iw INVALID'cOHNftHD AfC/OR SHITCH, CHECK COMTWND JUST GIVEN. 

1843 DEVERR DEVICE ERROR ON INPUT DEVICE. 

1844 EOn END OF MEDIUM. OCCURS DURING INPUT OPERATIONS WHEN 

1845 T« PROGRAM AtTEMPTS TO INPUT AND THE FILE IS AT 
18% AN ENOTSiOUS problem. FILE IN STORAGE IS PROBABLY 
ipu7 UIPCD OUT 

848 INVADR INVALID ADDRESS. MUST BE EVEN. 

\Uk ffl "^"> SS^SIPteM: "tl S8?l «T EXIST OH «IUn 

1853 
1864 

1865 UPD2 PROGRAM COMMANDS 

1857 FILlIcr" SETS UP TERMINAL FOR CORRECT PRINT 

1858 AFTER CRLF. 

1859 CLR<CR> CLEARS CORE BELOW UPDHTE PROGRAM ^ 

1^ PIP DEVI FILNAM.EXT^DEV2:FILNAM. EXT COPY FILE FROM DEVICE TO 6eviCE ^ 

ttS SAVE DEVFILNAM EXT ADR WRITES MEMORY CONTENTS ONTO CONTIGUOUS BLOCKS 

is SET DEV'FILnSTeXT READ CONTIGUOUS BLOCKS INTO MEMORY 

8fc7 MOD ADR MODIFIES CORE CONTENTS 



,•4 
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isbe 

IKS 

1870 
1871 
1872 
1873 
187M 
1875 
1B7E» 
1877 
1878 
187S 
1880 
1881 
1882 
1883 
188S 
1885 
1886 
1887 
1888 
188S 
1690 
1891 
18S2 
1893 
189M 
1895 
189b 
1897 
1898 
1899 
1900 
1901 
1902 
1903 
1904 
1905 
190b 
19D7 
1908 
1909 
1910 
1911 
1912 
1913 
191H 
1915 
191b 
1917 
1918 
1919 
1920 
1921 
1922 
1923 
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CORE 

LOCORE ADR 

HI CORE ADR 

DIR DEV.- 

DIRLP DEV: 

DEL 0EV:FILNfW1.EXT 

ZERO DEV: 

BOOT DEV: 

SflVn DEV: 

START 

START ADR 

ACT 

NOTACT 

FILE DEV:<DEV:FILENAM.EXT 



FILEF DEV 
FILET DEV 
FILEL DEV 
FILEG DEV 
FILED DEV 



<0EV:FILNAf1.EXT 
FILNAM.EXT 
FILNAM.EXT 
FiLNAfI.EXT 
FILNAfl.EXT 



TEXT DEV: FILNAfl.EXT 

PATCH DEV:FILNfl«.EXT<CR> 

PRINT DEV: FILNAM.EXT 
TYPE DEV;FILNAH.EXT 
DO DEVrFILNAM.EXT 
ASG PHYSICAL = LOGICAL 

EOT 

tC (CONTROL C) 
tZ (CONTROL Z) 
* 



i OR 



/LP 
/N 

ERRORS 

INVCND 
INVOEV 
INVADR 
INVNAn 



TYPES PROTECTION LIMITS 

ENTERS LOW PROTECTION LlfllT 

ENTERS HIGH PROTECTION LIMIT 

TYPES DEV DIRECTORY ON TTY 

TYPES DEV DIRECTORY ON LINE PRINTER. 

DELETES FILE FROM DEV DIRECTORY 

ZERO OlviCE DIRECTORY 

LOADS a.OCK 0 (JF DEV ctprtinG AT LOC QOOOOG 
WRITES HK ONTO DEV STARTIi'G AT BLOCK 30 
STARTS PROGRAM AT ITS TRAWLER ADDRESS 
STARTS PROGRAn AT AOR 
UP02 -ACT NODE" 
UPD2 oGt OF -ACT NODE- 
COPIES FILE(S) FROM ONE DEVICE TO 
ANOTHER. DELETING FILE OF SAME NAME 
BEFORE 60ING THE TRANSFER 
SAMESS FILE EXCEPT THAT WITH CASSETTE OR 
MAGTAPE FAST TRftrGFERS ARE PERFORMED (NO DIR CHECKING. 
^AOS FILE AND C^CKS FOR DEVICE 
eIwORS (FILE -TESr) 
LOADS FILES (ASSUMES AOS FORMAT) 

CHECKING FOR DEVICE AND FILE SIZE ERRORS 

C^TK^^FIlk^FOR PRINTING 

SABSs^^?!€'l&ST?piT&4 AN ABS FORMAT PROGRAM 
ON ANY XXO^ RANDOM ACCESS DEVICE. 
OUTPUTS A FILE TO T»C LIfC PRINTER 
OUTPUTS A FILE TO T>C COtSOLE TERMINAL 
EXECUTES A CONNAND FILE. 

IICAL DEVICE TO A 
. NAME 

TAPE HARK (FILE) ON MAGTAPE 
OR CASSETTE AFTER TAPE HAS BEEN POSITIOrCD. 
RETURNTO CoSlAND MODE (OPEN OUTPUT FILE IS CLOSED). 
ENDS IlfVr TO A TEXT FILE 
USED FOR FILE NAHIHC TO MEAN -ANY" 
(ANY FILE NAME OR ANY FILE EXTENSION) 
USED FOR FILE NAMING TO INDICATE A WILD 
CHARACTER (ANY CHARACTER HILL HATCH IT) 
USED IN A FILE OF EXECUTABLE COHHANDS 
TO START A COHMEHT LINE WHICH IS TO 
BE TYPED DURING EXECUTION 
SANE AS • BUT CAUSES A HALT AFTER 
THE COMMENT IS PRINTED 
LINE PRINTER OUTPUT 
ABORTS TYPE OUTS 




INVALID COMMAND 
INVALID DEVICE 
INVALID ADDRESS 
INVALID FILE NAME 



104 
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1S2S 

lis 

1930 
1S31 

IW 
1S35 
IS36 
1337 
1938 
IW 
1940 
1941 
1942 
1943 
1944 
1945 
19% 
1947 
1946 
1949 
1950 
1951 
1952 
1953 
1954 
1955 
1956 
1957 
1956 
1959 
I9b0 
1%1 
19b2 
I9b3 
1%4 
1985 
19b6 
1%7 
1988 
1%9 
1970 
1971 

1972 000001 
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NEXFIL 

OELOLD 

OEVERR 

NOTRQY 

CKSfCP 

EOfI 

DEVFUL 

INVCOR 

DIRERR 

OELERR 

POFLOU 

INVSW 

DUnP ERROR 



NON-EXISTENT FILE 

DELETE OLD FILE BEFORE GIVING COMMflNO 

DEVICE ERROR ON EITHER INPUT OR OUTPUT DEVICE 

P«P|R t5pE dEVICE IS NOT REfiDY 

CHECKSUn ERROR 

END OF MEDIUM 

DEVICE FULL 

HIGH CORrLiniT LOHER THflN LOUER CORE LINIT 

^^8u8f;;iM%TioM oh o,a^ disk 

PROGRflH TOO LftRCE TO L0«0 HITHIN EXISTING CORE SPACE 

INVALID SWITCH SPECIFIED IN COMttND STRING 

ACT NODE OHY DATA DUMPED ON OUTPUT DEVICE DOES NOT NATCH 



PERIPHERALS SiJPPORTED BY UPDATE PROGRAMS 



PR 

PP 

KB 

PT 

OKN 

NTN 



PCJ 1 HIGH SPEED PAPER TAPE tfAOER 
pen HIGH PAPER TAPE PUNCH 

TTY KEYBOATO. OR LOW SPEED READER 
TTY PRINTER AND PUNCH (UPOS) 
RKll/RKOS DISK (UP02, N=0-3) 
TR79F (UP02, N=0) 



(UPD2) 
(UPD2) 
(UP02) 



CREATING A NEU XXOP DECPACK 

ZERO OKI: 

LOAD OKOrRKOP.BIN 

SAVM OKI: 

DUMP OKl:n(OP.BIN 

LOAD OKO: UPD1.BIN 

DUMP DKi:UP01.BIN 

LOAD 0K0:UPD2.BIN 

DUMP DK1.-UPD2.BIN 

CREATING A NEM XXDP MAGTAPE (TR79F) 

5S: MTO: 
LOAD OKO:TROP.BIN 
SAVE HTOiTRDP.SAV 
DUMP MTO:TRDP.BIN 
LOAD DKOrUPOTR.BIN 
DUMP MTO: UPDTR.BIN 



tz 



.ENABLE AB5 
.END 
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onoxAe.nii symbol table 

PC s'/JXBOOr Rl =X000001 R3 =v.000003 



ERRORS DETECTED: 0 

OCFRULT GLOBALS GENERATED: 0 

«. OnOXAB. S£0/S0LOn0XA6 . mi 
R{M-TirC: I 3 0 SECONDS 
RUN-TINE RATIO: lQB/4=S3.b 
CORE USED: 5K (9 PAGES) 

EOFlOnOXABSEQ 00010000 770325 PDPIO MU 



R5 S-/.000005 = 000000 



7 



